home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / extras / prntutil / dublpag4 / dublpage.txt < prev    next >
Text File  |  1995-04-27  |  23KB  |  501 lines
  1.  
  2.  
  3.                             Double-Page IV
  4.  
  5.                                   by
  6.                           Douglas N. Wheeler
  7.                Copyright 1990-1991, All Rights Reserved
  8.  
  9.  
  10.  
  11. ______________________________________________________________________
  12.  
  13. INTRODUCTION
  14. ______________________________________________________________________
  15.  
  16.      Double-Page is a utility which allows laser printer owners to
  17. print text (ASCII) files such that two "pages" of the file are printed
  18. on each sheet of paper.  The pages are full 66 line by 80 character
  19. pages reduced in size so that two of them can be printed side-by-side
  20. on a standard 8-1/2" x 11" piece of paper.
  21.      Alternatively, you can print one 132-column page instead of two 
  22. 80-column pages.
  23.      You also have the option to print on both sides of the page,
  24. which allows you to print up to four pages on one sheet of paper!
  25.      This had two advantages over standard printing:
  26.      
  27.      1) You will need half (or a quarter) as many sheets of paper to
  28.         print the same file.  This becomes very important with long
  29.         program listings.
  30.         
  31.      2) Since Double-Page puts a larger margin along the "top" edge of
  32.         the page, it is a simple matter to three-hole-punch the pages
  33.         and put them into a 3-ring binder even if the page contains
  34.         full lines.
  35.  
  36. ______________________________________________________________________
  37.  
  38. USING DOUBLE-PAGE
  39. ______________________________________________________________________
  40.  
  41.      Double-Page was designed with simplicity in mind.  When you first
  42. run the program, you will find yourself with a standard GEM menu bar 
  43. on the screen.  The menus are layed out as follows:
  44.  
  45. Desk
  46.      About Double-Page IV...       Displays a title/copyright box.
  47.  
  48. File
  49.      Print File...                 Print a file using the parameters 
  50.                                    set up in the other menus.  This 
  51.                                    will be greyed out if you haven't 
  52.                                    selected a printer driver.
  53.      Use Default Font              Causes Double-Page IV to use the 
  54.                                    built-in font (typeface) when 
  55.                                    printing.
  56.      Use FILENAME.FNT              Causes Double-Page IV to use the 
  57.                                    font specified.  This will be 
  58.                                    greyed out if you haven't loaded 
  59.                                    an alternative font.
  60.      Load Font...                  Allows the loading of a font from 
  61.                                    disk.
  62.      Select Printer...             Allows the loading of a printer 
  63.                                    driver from disk.
  64.      Save Settings...              Saves your current set-up to disk 
  65.                                    such that the next time 
  66.                                    Double-Page IV is run, the 
  67.                                    configuration will be the same
  68.      Quit                          Exits Double-Page.
  69.  
  70. Layout
  71.      1 x 132 Chars.                Causes printout to use the one 
  72.                                    132-column page per side mode.
  73.      2 x  80 Chars.                Causes printout to use the two
  74.                                    80-column page per side mode.
  75.      Single-Sided                  Causes printout to use only one 
  76.                                    side of each sheet of paper.
  77.      Double-Sided                  Causes printout to use both sides 
  78.                                    of each sheet of paper.
  79.      Collate Pages                 Causes double-sided printouts to 
  80.                                    start with the even pages, then 
  81.                                    print the odd pages.
  82.  
  83. Options
  84.      Border                        Causes the printout to have a 
  85.                                    border around each page on a sheet.
  86.      Header                        Causes the printout to have a 
  87.                                    header at the top of each page.
  88.      Tab Size (8)...               Allows you to change the tab size. 
  89.                                    The number in parentheses is the 
  90.                                    current setting.
  91.      Edit Header...                Allows you to change the format 
  92.                                    and content of the header.
  93.      Audio Alerts                  Causes a bell to ring when user 
  94.                                    action is required (paper need 
  95.                                    turning over, an error has 
  96.                                    occurred, etc.).
  97.  
  98. ______________________________________________________________________
  99.  
  100. OPTIONS IN DETAIL
  101. ______________________________________________________________________
  102.  
  103. 1 x 132 Chars.
  104.  
  105.      This mode would be used when the lines in the file being printed 
  106. extend beyond 80 characters per line.  This is useful with spreadsheet
  107. printouts and program listings with long lines.  In this mode, each 
  108. page is identical to wide computer paper (132 columns x 66 lines) 
  109. compressed to fit onto an 8.5" x 11" sheet of paper (sideways)
  110.  
  111. 2 x 80 Chars.
  112.  
  113.      This mode would be used when the lines in the file being printed 
  114. fit within an 80 character line.  In this mode, each page is 
  115. identical to a standard 8.5" x 11" piece of paper (80 columns x 66 
  116. lines), although compressed to fit two pages per sheet of paper 
  117. (sideways).
  118.  
  119. Single-Sided
  120.  
  121.      This mode uses only the front of each sheet of paper.  This is 
  122. useful if you don't want to be around to turn the paper over, or if 
  123. you find single-sided printouts easier to handle.
  124.  
  125. Double-Sided
  126.  
  127.      This mode uses both sides of each sheet of paper.  Double-Page 
  128. IV will print the front of each sheet, then alert you to turn the 
  129. stack of paper over and reinsert it into the printer.  Once this is 
  130. done, it will print the back of each sheet.
  131.      This mode has several advantages over single-sided: it uses half
  132. as much paper, when placed in a binder, the pages are layed out such 
  133. that you can look at 4 pages at once, etc.
  134.  
  135. Collate Pages
  136.  
  137.      Because of the way that some printers feed paper, Double-Page IV 
  138. gives you the option of printing either the odd or even sides of the 
  139. sheets first.  When collation is off, Double-Page IV will print the 
  140. odd sides first (use this for the Atari SLM605 with the 
  141. straight-through paper feed).  When collation is on, it will print the
  142. even sides first (use this for the Atari SLM804).
  143.  
  144. Border
  145.  
  146.      This option turns the printed border on and off.  This is a 
  147.  matter of personal preference whether you want a border or not.
  148.  
  149. Header
  150.  
  151.      This option turns the printed header on and off.  The header, 
  152. when turned on, will appear at the top of each page.  You can edit 
  153. this header to include useful information about the printout 
  154. including the name of the file, page number, date, time, etc.
  155.  
  156. Tab Size
  157.  
  158.      This allows you to adjust the tab spacing.  When you selection 
  159. this option you will be presented with a dialog box containing 
  160. buttons for the most common sized (2, 4, 5, and 8 characters) as well 
  161. as a box for a custom size which you can set to any value from 1 to 
  162. 40 characters.
  163.  
  164. Edit Header
  165.  
  166.      This option allows you to edit the printed header in many ways.  
  167. You can enter any text which you'd like printed in the header, as 
  168. well as a number of 'variables' whose value will be filled in 
  169. automatically by Double-Page IV at print time.
  170.      The header is composed of three parts: the left part, which is 
  171. left-justified; the center part, which is centered over the page; and 
  172. the right part which is right-justified.
  173.      The variables which may be included are:
  174.  
  175.      %F  - inserts the name of the file being printed.
  176.      %P1 - inserts the current page number relative to the start of 
  177.            the current file.
  178.      %P2 - inserts the current page number relative to the start of 
  179.            the current job (which may consist of multiple files).
  180.      %D1 - inserts the current date of the month (1-31).
  181.      %D2 - inserts the current date of the month with a leading 0 if 
  182.            the date is less than 10 (01-31).
  183.      %D3 - inserts the current day of the week (Sunday - Saturday).
  184.      %M1 - inserts the current month (1-12).
  185.      %M2 - inserts the current month with a leading 0 if the month is 
  186.            less than ten (01-12).
  187.      %Y1 - inserts the current year as a 2-digit number (00-99).
  188.      %Y2 - inserts the current year as a 4-digit number (1800-2999).
  189.      %H1 - inserts the current hour in 12-hour format (1-12).
  190.      %H2 - inserts the current hour in 24-hour format (0-23).
  191.      %M  - inserts the current minute (00-59).
  192.      %S  - inserts the current second (00-59).
  193.      %AP - inserts the text 'a.m.' or 'p.m.' for morning or 
  194.            afternoon, respectively.
  195.      %%  - inserts a '%' character.
  196.  
  197.      The time and date values are computed at the beginning of each 
  198. file and won't change in the middle of a printout.
  199.      Keep in mind that if the parts of the header are too long, they 
  200. may overlap each other.  This won't do any harm, it'll just look 
  201. funny.
  202.  
  203. Audio Alerts
  204.  
  205.      With this option selected, the computer will use an audio signal 
  206. to alert you when it's time to turn the paper over, or when an error 
  207. has occurred.  This is useful if you want to be doing other things 
  208. while a printout is in progress.
  209.  
  210. ______________________________________________________________________
  211.  
  212. FONTS
  213. ______________________________________________________________________
  214.  
  215.      Double-Page IV has one font (typeface) built in and has the 
  216. ability to load one additional font from disk.  The built-in font 
  217. contains most of the characters you will need, but does not includes 
  218. the ST's extended character set (which includes most foreign 
  219. characters).
  220.      Included with Double-Page are several fonts, including these:
  221.  
  222.      DEFAULT.FNT  - this is a copy of the built-in font, but since 
  223.                     it's disk loaded, it may be modified.
  224.      DPRAZR06.FFT - this is the same as the RAZR06LS.FNT which is 
  225.                     included with the SLM804 (the characters are the 
  226.                     same, the file isn't).
  227.      SYSTEM.FFT   - this is the same as the LIST06LS.FNT which is 
  228.                     included with the SLM804, but only contains the 
  229.                     characters from 0-127.
  230.      SYSTEMA.FFT  - this is the same as SYSTEM.FNT, but includes all 
  231.                     256 characters in the ST's character set.
  232.  
  233.      Double-Page IV supports two different formats for the font 
  234. files.  The first is the .FNT files which are readable ASCII files 
  235. which can be edited with any text editor.  These files take several 
  236. seconds to load.
  237.      The second format is a compressed format which, although not 
  238. easily editable, will load very quickly and take up less disk space.  
  239. These files have a .FFT (fast-font) extender.
  240.      See the section entitled 'FONT FILE FORMATS' for more 
  241. information on the internal structures of the font files.
  242.  
  243.      Included with Double-Page IV is a font converter written by Ken 
  244. Badertscher which will convert between .FNT and .FFT formats.  Many 
  245. thanks to Ken for this utility!
  246.  
  247. ______________________________________________________________________
  248.  
  249. PRINTERS
  250. ______________________________________________________________________
  251.  
  252.      Double-Page IV has the ability to load printer drivers for 
  253. virtually any 300 dpi printer (laser, inkjet, etc.).  Included with 
  254. Double-Page IV is a driver for the SLM804/SLM605.
  255.      You'll find that Double-Page IV prints significantly faster than 
  256. previous versions.  This is a result of certain portions of the 
  257. program that were moved to the printer driver and written in assembly 
  258. language.
  259.      See the section entitled 'PRINTER DRIVER FORMAT' for information 
  260. on writing your own drivers.
  261.  
  262. ______________________________________________________________________
  263.  
  264. SLM804/SLM605 DRIVER
  265. ______________________________________________________________________
  266.  
  267.      The SLM804/SLM605 can automatically detect the device number of 
  268. the printer (unlike previous versions of Double-Page).  Also, the SLM 
  269. driver accesses the SLM directly and doesn't use the Diablo emulator, 
  270. GDOS, LaserBrain, or any other driver.
  271.      The SLM driver will detect SLM804 errors when they occur and give
  272. you the opportunity to correct the problem and continue.  Possible
  273. errors are:
  274.  
  275.      INSUFFICIENT MEMORY - there is not enough memory to create the 
  276.           page.  The driver needs to have 1 Megabyte of RAM free for 
  277.           the page.
  278.      TONER EMPTY - your toner cartridge needs replacing.  You may be 
  279.           able to continue printing for several more pages, though.
  280.      PRINTER NOT READY - the printer is not warmed up.  Wait until 
  281.           the green 'Ready' indicator is lit before continuing.  This 
  282.           will also occur if there is no SLM connected.
  283.      OUT OF PAPER - the paper tray is empty.  If you attempt to print 
  284.           without any paper in the tray, Double-Page will revert to 
  285.           manual feed.
  286.      DRUM EMPTY - your printer drum needs replacing.  You can 
  287.           continue, though print quality may degrade.
  288.      PAPER JAMMED - a sheet of paper jammed in the printer.  Remove 
  289.           it before retrying.  If you are printing the backside of a 
  290.           double-sided document, you should put a blank sheet of 
  291.           paper in the paper tray to keep the page arrangement 
  292.           correct.
  293.      COVER OPEN - the cover of the printer is open.  Close the cover 
  294.           and wait for the green "Ready' indicator to light.
  295.      GENERAL ERROR ## - an error of type ## has occurred.  Generally, 
  296.           these errors indicate either a paper jam (see PAPER JAMMED, 
  297.           above) or some sort of hardware problem.  Consult your 
  298.           SLM804 manual or local dealer for assistance.
  299.  
  300. ______________________________________________________________________
  301.  
  302. PRINTING
  303. ______________________________________________________________________
  304.  
  305.      You should make sure all of your options are set up before 
  306. selecting the 'Print File...' menu option.  Once you select this 
  307. option, you will be presented with a standard file selector where you 
  308. can select the file(s) you wish to print.  You can either select a 
  309. single file, or type in a wildcard such as '*.TXT' which will print 
  310. all files which have a .TXT extender in the selected folder.
  311.      If you are using a wildcard, the files will be printed in the 
  312. order they are on the disk (not necessarily alphabetically), and you 
  313. have selected double-sided printing, you will be prompted to turn the 
  314. paper over at the appropriate times and remove the paper between
  315. documents.
  316.      During printing, a status box will be displayed showing the 
  317. printer in use as well as the file being printed and the current page
  318. number being printed.
  319.      Double-Page IV also supports over-strike printing.  If a file 
  320. contains a backspace character, Double-Page will back up and print 
  321. the next character on top of the previous one.  If the two characters 
  322. are the same, the second one will be offset slightly to provide a 
  323. bold appearance.  This allows for boldface characters, underlining, 
  324. and overstriking.
  325.  
  326. ______________________________________________________________________
  327.  
  328. COMMAND LINE
  329. ______________________________________________________________________
  330.  
  331.      Double-Page IV also lets you pass filenames on the command line.
  332. This can be done in several ways:
  333.  
  334.      Using Neodesk 3 or the Atari TT, you can drag one or more files
  335. to the DUBLPAGE.PRG icon and they will each be printed one after
  336. another.  You can also place the DUBLEPAGE.PRG icon on the desktop for
  337. easy access.
  338.      Using Neodesk 3, or a TT, you can use the 'Install Application'
  339. menu option to set Double-Page IV to be a GEM application which take 
  340. parameters.  Once this is done, double-clicking on DUBLPAGE.PRG will 
  341. bring up a dialog box where you can type in the name of the files to 
  342. print.  Simply type in the file(s) which a space between each name.
  343.      You can also use Codehead's Hotwire to pass a filename on to
  344. Double-Page IV automatically, saving you from typing the filename.
  345. Using a CLI (Command Line Interface), you can type the filenames as
  346. parameters for Double-Page IV, such as:
  347.  
  348.      DUBLPAGE FILE1.TEXT FILE2.TXT
  349.  
  350. Some CLIs require a variation on this since this is a GEM 
  351. applications to keep the screen from getting messed up.
  352.  
  353.      Double-Page IV will also accept wildcards on the command line.  
  354. Combining this will the ability to pass several names provides many 
  355. possibilitys, such as '*.C *.H' to print all the .C and .H files in 
  356. the current folder, or '*.S READ.ME' which will print all the .S 
  357. files along with the file named 'READ.ME'.
  358.  
  359. ______________________________________________________________________
  360.  
  361. FONT FILE FORMATS
  362. ______________________________________________________________________
  363.  
  364.      Double-Page IV supports two font file formats:
  365.  
  366. .FNT files - these are ASCII (readable/editable) files formatted as 
  367. follows:
  368.  
  369.      DP3  DON'T CHANGE THIS LINE!
  370.      189  Copyright symbol
  371.      0
  372.      0
  373.      00000000000001111111111111000000
  374.      00000000000111111111111111110000
  375.      00000000001110000000000000111000
  376.      00000000001100001111111100011000
  377.      00000000011000011111111110001100
  378.      00000000011000110000000011001100
  379.      00000000011000110000000011001100
  380.      00000000011000111100001110001100
  381.      00000000001100001100001100011000
  382.      00000000001110000000000000111000
  383.      00000000000111111111111111110000
  384.      00000000000001111111111111000000
  385.      0
  386.      0
  387.      999  End of data - DON'T CHANGE THIS LINE!
  388.  
  389. The file consists of three basic parts:
  390.      The header - the first line which must begin with 'DP3'.
  391.      The characters - each character consists of two parts:
  392.           The header - the first line which begins with the ASCI code
  393.                        of the character.
  394.           The character - 16 lines of 32-bit binary numbers.  When 
  395.                           printed, a 1 becomes a dot.  Note that the 
  396.                           characters are pre-rotated for printing.
  397.      The trailer - the last line which must begin with '999'.
  398.  
  399. .FFT files - these are similar to .FNT files, but the are pre-encoded 
  400. into their binary counterpart.   A .FFT file must contain all 256 
  401. characters in the ST's character set (although characters may be 
  402. blank).  The characters are in order by ASCII number, and consist of 
  403. 16 longwords.
  404.      Character 0 (which is never used) must be overlayed with a text 
  405. string starting with 'DP4'.  This is how Double-Page IV detects the 
  406. difference in the 2 different font types; it reads one line of text 
  407. from the file and sees whether it starts with 'DP3' or DP4'.  Since 
  408. that initial line is read as text, there must be a cr/lf to terminate 
  409. it.
  410.  
  411.      With both types of fonts, once they are loaded into Double-Page 
  412. IV, the characters 1 through 6 get overlayed with the border 
  413. characters, so those character may be left blank if desired.
  414.  
  415. ______________________________________________________________________
  416.  
  417. PRINTER DRIVER FORMAT
  418. ______________________________________________________________________
  419.  
  420.      Included with Double-Page IV is a file called PRINTER.S which is 
  421. a basic skeleton for a printer driver.  Double-Page IV calls the 
  422. printer driver and passes the address of a page layout array and the 
  423. address of the font the user selected.  The driver must then convert 
  424. the page layout array into a bitmap and print it to the printer.  The 
  425. driver can return an error code which Double-Page IV can act upon in
  426. several ways.
  427.      Consult the PRINTER.S file for additional information and sample 
  428. code for creating a 300 dpi bitmap from the page layout array.
  429.  
  430. ______________________________________________________________________
  431.  
  432. SHAREWARE
  433. ______________________________________________________________________
  434.  
  435.      Like much of today's "free" software, this one isn't really
  436. free.  You are free to try it out without payment, but if you decide
  437. you like it and would like to continue using it, I do request that
  438. you send me a small shareware fee ($10 is suggested) to help offset
  439. the time I've spent developing this program.  Shareware payments
  440. also help decide the future of this program.  Send any shareware
  441. payments to the address below.
  442.  
  443. ______________________________________________________________________
  444.  
  445. VERSION II
  446. ______________________________________________________________________
  447.  
  448.      Version II of Double-Page added the ability to print double-sided
  449. pages, as well as an information line at the top of each "page"
  450. consisting of the filename, date, time, and page number.
  451.  
  452. ______________________________________________________________________
  453.  
  454. VERSION III
  455. ______________________________________________________________________
  456.  
  457.      New features include: SLM804 error handling, custom fonts, and 
  458. custom default settings.
  459.      Bug fixes include: formfeed character now handled properly (it 
  460. wasn't handled at all previously), there are now 66 lines per "page"
  461. (version II printed 67), and the mouse pointer now changes to a "busy
  462. bee" during printing and font loading.
  463.  
  464. ______________________________________________________________________
  465.  
  466. VERSION IV
  467. ______________________________________________________________________
  468.  
  469. New features include:
  470.    - True GEM application with menu bar
  471.    - Supports 1x132 printouts
  472.    - Allows complete editing of the header
  473.    - Allows the heard and border to be turned off
  474.    - Simplifies selecting arbitrary tab sizes
  475.    - Support the new .FFT small, fast font file format
  476.    - Supports alternate printers through loadable printer drivers
  477.    - Allows for wildcard (and multiple wildcard) printouts
  478.    - SLM driver automatically detects the SLM device number
  479.    - Allows pages to be collated
  480.    - Has option for audio alerts for user interaction
  481.    - Print speed has been increased greatly
  482.    - Overstrike printing is supported
  483.  
  484. ______________________________________________________________________
  485.  
  486. THE FUTURE
  487. ______________________________________________________________________
  488.  
  489.      I have a few ideas for future versions of Double-Page.  Whether
  490. or not there even ARE future versions depends upon shareware
  491. contributions.
  492.      If you have any suggestions, comments, or complaints, send them
  493. to me at (address subject to change):
  494.  
  495.      Doug Wheeler
  496.      3655 S. Delaware St., #317
  497.      Englewood, CO  80110
  498.  
  499.      GEnie address:  DOUG.W
  500.      
  501.